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"THE SCREENS MANIPULATION UTILITY" 


PIX-FX is a unique menu-driven, SCREENS manipulation program 

featuring a variety of tools and utilities designed to help you 
create special graphic effects from your collection of SCREENS. 
The Perspective utility gives you a powerful tool to manipulate 
SCREENS in 3-dimensional space thus creating the perception of 
depth and perspective. This also frees up more space on the 
screen for other objects. Planet Maker gives you the tools to 
wrap any SCREENS around a 3-D sphere. Size and tilt are user 
selectable. You will also be able to Magnify, Reduce, and Copy & 
Paste a user specified window and transfer it to another 
SCREENS. There are many applications ideally suited to 
PIX-FX: Desk-Top Publishing, 3-D title screens, 3-D lettering 
and fonts, 3-D spheres, combining reduced RLE’s and SCREENS, 
artistic creations, personal amusement, etc. The power is now in 
your hands to do something creative with those SCREENS and RLE’s 
you’ve been collecting. 


PIX-FX IS PACKED WITH FEATURES: 


-Place SCREENS in Perspective 3-D space 
-Magnify user specified portions of SCREENS 
-Reduce all or part of SCREENS 

-Copy and Paste portions of SCREENS onto others 
-Create 3-D, user defined spheres from SCREENS 
-Easy manipulations via user specified windows 
-Pull-Down Menus 

“Quick Help Menu 

-Unique windows let you see whats stored in RAM 
-Inverse, Horizontal Flip, and SCREENS Merge utilities 
-Smart cursors 

-Variable speed and alignment cursors 

-User modifiable BASIC allows for disk systems 
-SAVE, LOAD, Swap, and Move SCREENS 

-Special compressed code SAVE routine 

-Quick start PIX-FX Tour in documentation 

-Easy to read documentation 

-Easy access to BASIC, no copy protection 

-Many other documentated features 
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If you wish to jump right into this program before reading the 
documentation, just turn to the PIX-FX Tour chapter. I recommend 
that you read the chapter on PIX-FX Terminology and conventions. 


INTRODUCTION 


PIX-FX is a unique collection of SCREENS manipulation utilities 
designed to help you create your own special picture effects 
from one or several SCREENS’s. You will also be able to magnify, 
reduce, or copy a user specified window and transfer it to 
another SCREENS in a building block fashion. Another unique 
feature will allow you to render a 3-dimensional perspective 
view of any SCREENS by simply positioning a cursor at each of 
the four corners representing 3-D space. The Planet Maker 
utility produces a special graphic effect by folding a SCREENS 
into a sphere of any size you select. PIX-FX contains many 
other features designed to help you create and enhance your 
SCREENS creations. Some of its many applications are: reduce 
and combine several pictures into one, desk-top publishing, 
special title effects, create 3-D round objects, RLE’s, 
digitized pictures, create 3-D lettering, artistic distortions, 
personal amusement. 


PlULLEL-DOWN MENUS 


When you first run PIX-FX, you will be presented with a 
pull-down menu with a black & white copy of the title screen 
behind the Main Menu. Move the selection bar within the the 
menu by pressing the Up arrow (#7 key) or the Down arrow (#6 
key). Once you have moved the selection bar over your choice, 
press "ENTER" to activate your selection. To EXIT a menu without 
making a selection, press the "@" key. If you are using the Main 
Menu, pressing "@" will EXIT you to BASIC. To re-enter PIX-FX 
after returning .to BASIC, just RUN as usual. You may modify or 
Change any partjthe BASIC program to suit your needs such as 
SAVE or LOAD to disk or COPY to full size printer. Beware that 
there is Some room in memory for expansion of BASIC, however, 
not alot. If you get an "Out of Memory" error message after 
RUNning a modified program, it means that you need to find ways 
to reduce the size of your BASIC additions. See the Chapter on 
User Customizations. 
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THE HELP MENU 


When you select HELP on the PIX-FX Main Menu you will be 
presented with the Help Menu. Select the utility for which 
you need help and press "ENTER". A brief explanation will appear 
as scrolling text at the bottom of the screen. To EXIT the Help 
message, press "ENTER" and you will be taken back to the Main 
Menu. 


PIxX-FXRKX TERMINOLOGY &® CONVENTIONS 


PIX-FX utilizes a 256 X 176 pixel screen with the bottom two 
Character lines reserved for user input and messages. PIX-FX 
does not use the color attributes during screen manipulations. 
All final SCREENS’s contain black and white attributes. Use any 
picture paint program to colorize your PIX-FX creations. 


PIX-FX uses two areas of RAM to store SCREENS’s being processed. 
These storage areas are called the Working Screen (WS) and the 
Final Screen (FS). The utilities; Planet Maker, Perspective, 
Magnify, Reduce, and Copy & Paste all use the following 
convention. The original SCREENS to be worked upon is stored in 
the Working Screen area and the manipulation result SCREENS is 
stored in the Final Screen area and is always displayed behind 
the Main Menu. In all of the above mentioned programs, cursors 
are controlled by the keyboard arrow keys (5,6,7,8). A cursor is 
used to place various cursor markers onto the screen” thus 
outlining a window which designates the area to be worked upon 
Or an area to place a window. The cursor shapes are an important 
clue to help you remember which corner of a window you need to 
designate. For example, you will always begin by positioning the 
upper left-hand corner of the window you are defining, 
therefore the cursor will look like an upside-down "L" ( [ ). 
Some programs require you to define all four corners of a 
window, and some only require two corners to be defined. Check 
the Help Menu if you need a reminder. 


Once you have chosen any of the forementioned utilities from the 
Main Menu, you will be presented with the LOAD/MOVE Menu’ which 
Will allow you to place a SCREENS to be worked on into the wS 
area. Two small windows will also be displayed and contain 
reduced versions of the WS and FS areas. This allows you toa 
visualize what SCREENS is stored in each area. 


The LOAD/MOVE Menu provides you 
with options to Copy, LOAD, or 
swap SCREENS within the storage 
areas. Once you are satisfied 
with your choices, exiting the 
menu will allow you to continue 
with your original Main Menu 
Choice. 


) 


The SCREENS Storage Menu gives 
you the following options: 


-View SCREENS (Select WS or FS) 

-SAVE Final Screen (Regular 
SAVE or compressed SAVE) 

-LOAD/MOVE SCREENS (Puts you in 
the LOAD/MOVE Menu) 

-COPY SCREENS (COPY’s picture 
to 2949 printer). You can add 
your own printer options to 
this menu by changing some 
BASIC lines. See Chapter on 
User Customization. 


SCREENS MANIPULATIONS 


PLANET MAKER 


Planet Maker produces a special graphic effect by wrapping a 
SCREENS around a sphere, thus producing a 3-D globe. After the 
LOAD/MOVE Menu, choose where you want the sphere to be drawn 
(Blank Screen or FS). Next input the angle (in degrees) you want 
to tilt your sphere. The tilt is about an imaginary point at the 
sphere center. Tilt left is positive, tilt right is negative. A 
value of plus or minus @ to 188 degrees is sufficient. The 
program will do some calculations while displaying a countdown. 
Next move the "cross" cursor to locate the coordinates of the 
sphere’s center. Press "ENTER" to set the position. Using the 
left or right arrows increases the size of the cursor and 
indicates the size of the outer edges of the sphere. Use the up 
and down arrows to decrease the scale. Press "ENTER" when you’ve 
decided in the scale. The value displayed is in terms of per 
cent of the total height of the "Y" axis. 


Next you must choose the offset value. Keep in mind that’ since 
the SCREENS is wrapped around the entire globe in 3-D, you only 
see the part of the SCREENS facing you. The other 58% is on the 
"dark" side of the planet. Therefore you are seeing 16 of 32 
Character squares at any one time. With an offset of zero, your 
viewing window involves character spaces 9 to 15, and spaces 16 
to 31 are not visible. By choosing an offset @ to 16, you can 
designate which 16 character window you want to view. 
When the planet is finished drawing, you’ll hear a beep, then 
you can press "ENTER" to get the Main Menu back. The program 
will automatically store the finished work in the FS area. 


PERSPECTIVE RENDERING 


Perspective takes a complete SCREENS and generates a 
S-dimensional perspective view that you define by the four 
corner cursors that define the window. You will be presented 
with the LOAD/MOVE Menu first. Be sure you have the SCREENS to 
be manipulated stored in the WS area. Next you choose which 
perspective option you would like. Option (1) generates 
@ window where left and right sides are parallel and top = and 
bottom sides are non-parallel. Option (2) generates a window 
where top and bottom lines are parallel. 


Next indicate where you want to overlay your perspective 
drawing (on the FS screen or on a blank screen). The next step 
is to position the four corner cursors which will define the 
shape of the window. The convention is always to start with the 
Upper Left hand corner, then Lower Left, Lower Right, and 
finally the Upper Right corner in a counter-clockwise direction. 
Use the arrow keys to position each cursor at the choosen 
coordinate and press "ENTER" to set the position. If you 
attempt to move a cursor to an illegal position, error trapping 
will disable the cursor in that direction thus preventing you 
from making a positional error. 


If you wish to slow down the cursor for accurate placement, 
press and hold down "CAP SHIFT" key while pressing an arrow key. 
The "X" and "¥" coordinate values are displayed at the bottom if 
you wish to use them. To aid in alignment of the corners with 
other points on the screen, press the "C" key and the cursor 
will shoot out rays to the borders. 


After you’ve placed the fourth corner cursor, you can press "xX" 
at the prompt, to redo the cursor assignments or press "ENTER" 
to continue with the program. At the outline prompt, indicate 
whether you wish the final drawing to retain the border outline. 
At the beep, the program is finished and the picture is stored 
in the FS area. 


MAGNIFY 


Magnify works different from any other magnify utilities. You 
will not input the number of times to magnify a window. Instead 
you will first define the window to be magnified then you will 
outline a window defining the size you want the first window to 
be. If the second window is larger than the first window then 
first window is magnified and takes the shape of the window. 
After you exit the LOAD/MOVE Menu you are asked if you want 
AutoProportioning turned on. This feature is used to assist in 
maintaining consistant screen ratios between the "X" and "yY" 
axes so that the window doesn’t become stretched and distorted 
on either axis. 


If you choose "Y" then the Y-axis is 
automatically increased or decreased as the X-axis is 
increased or decreased. The goal here is to designate the window 
to be magnified on the WS area by placing two corner cursors, 
one at the Upper Left corner and one at the Lower Right corner. 
Press "ENTER" to set your cursor. Once you’ve identified your 
window you will be prompted to indicate where you want to put 
the area being magnified; (1) Whole screen or (2) a user defined 
window. If you choose whole screen then the area being magnified 
will #i11 the entire screen and the program ends. If you select 
choice #2 then you will be prompted to choose where you want 
your window to be placed ; (1) Blank screen, (2) WS area, or (3) 
FS area. Use the UL and LR corner cursors to locate the 
magnification area and press "ENTER". CAPS SHIFT gives 
Single-step cursor speed. Pressing "C" gives alignment rays. 


REDUCE 


Follow prompts. Very similar to Magnify except make the second 
window smaller than the first. 


COPY & PASTE 
Follow prompts. Similar to Magnify except that when you are 
ready to locate and Paste your window you only need to locate 


the UL corner cursor and press "ENTER". 


SCREENS MODIFIER UTILITIES 


MERGE 


This utility will merge two SCREENS into one and place the 
result into the FS area. Follow the prompts. Make sure that one 
SCREENS is in the WS area and the other is in the FS area. 
INVERSE 

This utility will invert each pixel in the FS area thus each INK 
pixel becomes PAPER and each PAPER pixel becomes INK. The result 
is placed into the FS area. 

HORIZONTAL FLIP 


This utility produces a mirror image of the Final screen. 


COMPRESSED SCREENS SAVE 


The SAVE function of the SCREEN® Storage Menu gives you the 
option to SAVE a SCREENS in the normal way or to compress’ the 
SCREENS (reduce file size) and store as CODE. Compressing has 
two advantages: (1) it usually reduces the size of the SCREENS 
by an average of 48 to 5S@% and (2) the compressed code is 
preceeded by a short bit of machine code which expands the 
compressed SCREENS back to its normal size. Therefore, a simple 
BASIC line like “RANDOMIZE USR 48246" will instantly produce the 
full SCREENS. This in itself has many advantages. Normal SCREENS 
take up to 6912 bytes of RAM and are slow to LOAD from cassette 
plus you need two machine code programs to store and recall the 
screens rapidly. The large size of a SCREENS file limits the 
number of them you can store in RAM. A compressed PIX-FX SCREENS 
will be smaller,is freely relocatable, and has its own built-in 
self-resolving code. You can achieve a simple form of animation 
by storing a number of slighty different compressed SCREENS then 
calling each one in sequence, like page flipping cartoons on a 
note pad. See the chapter on Advanced User Tips for using 
compressed SCREENS. 


USER CUSTOMIZATION 


1. To make a cassette copy of PIX-FxX: 

LOAD PIX-FX in the normal way. When the program has finished 
LOADing you will get a prompt to "Press A Key To RUN", it is 
important to press CAPS SHIFT and BREAK at this point. Do not 
RUN PIX-FX and then try to SAVE it. Prepare a blank tape for 
recording the SAVE. Type in the immediate mode (no line number), 
RUN 9999, PIX-FX SAVES in four parts. 


CAUTION! The file called title is a compressed SCREENS which is 
LOADed and expanded in line 9999. When you first RUN PIX-FX, the 
title SCREENS is expanded and stored at an address which 
overwrites the compressed code you want to SAVE. Therefore, if 
you try to SAVE PIX-FX after running the program, the next time 
you LOAD PIX-FX, the program will crash when it tries to call 
USR 48246 in line 9999, 


2.ToO customize PIX-FX for any storage device other than cassette 

(disk drives, etc.), you should change the following BASIC 

lines: 

Line 1226; This is the SAVE SCREENS line. (N#% is the file name 
from line 55992). 

Line 1249; This is the SAVE CODE line for compressed SAVE. 

Line 1356; This is the LOAD SCREENS line. 

Line 1499; This is the COPY SCREENS to 2649 printer line. You 
can add your own USR call to dump the screen to a 
full sized printer. 


If you wish to add a CAT routine before a LOAD, write a BASIC 
routine at line 1355. 


In line 9998, remove the BASIC that reads, "POKE PEEK 23631+256* 
PEEK 23632+5,191". 


The following areas of RAM are free for user use, such as 


® 


relocatable printer drivers: 59456 to 59974 (519 bytes), 
62188 to 62868 (769 bytes), ond the printer buffer at 23294 (256 bytes), 


The Main Menu is at line 48. The Help Menu is at line 598. The 
SCREENS Storage Menu is at line 1999. The LOAD/MOVE Menu is’ at 
line 13982. 


ADVANCED USER TIFS 


Some important addresses: 
location of Final Screen-49192 
location of Working Screen-46336 


Some Important POKEs: 

Speed of Menu Select Bar- 33614, (12) 

Compressed SAVE Start of SCREENS byte: 36633, (64) + 

36689, (64). End of SCREEN byte: 36672,(91) + 36689, (91). 
You can modify the start and end bytes to SAVE various sections 
of the screen as follows: 


To SAVE Start End (no attributes) 
Top 1/3 of screen 64 wz 
Middle 1/3 of Screen 72 8S 
Bottom 1/3 of screen 85 6s 
Top 2/3 of screen 64 89 
Bottom 2/3 of screen 72 8s 
Whole screen (no attr.) 64 8s 
Attributes only ss 91 


When using Perspective and you wish to overlay one window over 
another screen, Perspective will "OR" or merge the pixels 
together. If you wish to overwrite what is beneath the new 
window, POKE 69145,119 which will "AND" the pixels and therefore 
PAPER-over any pixel beneath. POKE 69145,9 to "OR" the pixels. 


Some important calls: To Store FS=59975, to Recall FS=59987, to 
Store WS=69981, to Recall WS=68969 


When using Planet Maker, not all SCREENS look interesting after 
wrapping. Other than using "WORLD.C%S" SCREENS, Planet Maker 
produces the best results when wrapping repetative patterns such 
as item #6 in PIX-FX Tour. 


Due to the TIMEX 2968’s rather coarse 256x176 pixel resolution, 
results from Perspective may, at times, be better than others. 
Experiment with the differences between the "OR" and "AND" 
options at address 69145. 
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1. Select SCREENS Storage from Main Menu (Press down arrow and 
hit ENTER). 


2. Select LOAD/Move SCREENS, ENTER. 
-This option gives you two half sized windows displaying 
contents of the Final Screen (FS) and the Working Screen 
(WS). 
-Notice that there is nothing in the WS area. 


3. Select COPY FS to WS from the Menu and hit ENTER. 
-Now you have placed a Copy of the FS into the WS area. 


4. Select LOAD PIC to WS, ENTER. 
-LOAD "WORLD.CS" (should be next on tape after PIX-FX). 
-Try swapping FS and WS a few times. 
-Put "WORLD.CS" into the WS area. Hit ENTER to EXIT. 
-Don’t forget that the MAIN MENU always displays the FS 
beneath it. 


5S. Select Perspective from the MAIN MENU. 
-You should see the LOAD/Move Menu. 

-Since Perspective will manipulate the SCREENS found in 
the WS area check to see that you have the desired 
SCREENS in the WS area. 

-If everything is OK in the WS area, press ENTER to 
EXIT. Sometimes you may wish to LOAD the FS area with 
another SCREENS because some Menu choices allow you 
to place your manipulated picture onto the existing 
FS SCREENS or to a blank screen. 

-You should now be in the Perspective utility. 

-Input "1" to select parallel sides. 

-Overlay onto a blank screen, "B". 

-Use the arrow keys to place the Upper Left corner 
cursor at X=9, y=13@0. If the cursor moves too fast, 
hold down the CAPS SHIFT key and press the arrow 
key step-wise to slow it down for precision 
placement. 

-Press ENTER to set your selected point. 

-Move Lower Left corner cursor to xX=6, Y=28 and 
press ENTER. Cursor is intelligent and will prevent 
you from going in an erroneous direction. 

-Move Lower Right corner cursor to x=128, y=43,ENTER 

-Move Upper Right corner cursor to the same height 
as UL corner cursor you set first. Press the "C" 
key to assist in alignment. Use "CAPS SHIFT" for 
slow cursor. Hit ENTER. 

-You should be finished and are now given a chance 
to start over if you made a mistake. Hit ENTER if 
everything is ok and you want to proceed. 

-Press "Y" for outline to appear in final rendering. 

-VOILA!!! Hit ENTER to get back to Main Menu. 


6. Press "9" to EXIT back to BASIC. 

-Now do a "CLS" and type the following in immediate mode, 
and all on one line. Check your work carefully before 
hitting ENTER: 

@ 


FOR N=1 TO 784: PRINT “L"$: NEXT N 
You should get a full screen pattern. Now, in 


immediate mode again, type: RANDOMIZE USR SW (ENTER). 


This will store your pattern in the WS area. 
-Now RUN PIX-FX. 


7. Select Planet Maker from Main Menu. 


-No changes need to be made using the LOAD/Move Menu, 


press ENTER to proceed. 
-We want to render our planet onto the FS area, s0 
"2", ENTER. 
-Enter the angle that you want to tilt your sphere. 


(+) direction is counterclockwise, the (-) direction 


clockwise. 


the 


50 


press 


The 


is 


-The computer will do some calculations. Wait for prompt. 


-Move the "CENTER" cursor to approximately X=18¢, 
Press ENTER to set center coordinate of sphere. 


-Use "<--" & "-->" arrows to increase sphere diameter, 


up/down arrows to decrease diameter, press ENTER. 
-Choose pic offset. (For now, use any number) 

-A beep will let you know that you are finished, 
will bring you back to the Main Menu. 


8. Select Reduce from the Main Menu. 
-LOAD "BTRFLY.C#" to the WS area and hit ENTER to 
LOAD/MOVE Menu. 
-Press "Y" for auto proportioning. 
-Reduce whole screen, input "1". 
-Input "3" to print selected window to FS area. 


Y=130 


use 


ENTER 


EXIT 


-Locate UL corner cursor where you want to place reduced 


picture. Try the lower right corner of the screen 


about X=128, Y=78, press ENTER to set point. 
-The last cursor to locate is the LR corner cursor. 
"{--" & "-->" arrows increase or decrease the window 


at 


The 


in 


proportion to the actual screen dimentions. The Up & Down 


arrows are disabled. 


-Run the LR corner cursor all the way to the right, ENTER. 


9.Select Copy & Paste from the Main Menu. 
-Using the LOAD/Move Menu, Copy FS to WS and EXIT to 
Copy & Paste utility. 


the 


-Use the UL and LR corner cursors to frame in N. America 
on the map. Don’t forget to use "C" to assist in framing 


the area to be copied. Press ENTER when done. 
-Print to FS at prompt. (3) 
-Now, locate the UL corner cursor to the area you 


want 


your copy to go. Try X=45, Y=175. Press ENTER and VOILA! 


19.Select Invert SCREENS frem the Main Menu. 


11.Select Horizontal Flip. 


This concludes our brief PIX-FX TOUR, have fun experimenting. 


There are many creative ways to use PIX-FX, whether you use 
for professional or person2i use, or for your own amusement. 
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program before reading the 
FX Tour chapter. I recommend 
Terminology and conventions. 


INTRODUCTION 


PIX-FX is a unique collection of SCREEN® manipulation utilities 
designed to help you create your own special picture effects 
from one or several SCREEN$’s. You will also be able to magnify, 
reduce, or copy a user specified window and transfer it to 
another SCREEN® in a building block. fashion. Another unique 
feature will allow you to render a 3-dimensional perspective 
view of any SCREEN® by simply positioning a cursor at each of 
the four corners representing 3-D space. The Planet Maker 
utility produces a special graphic effect by folding a SCREENS 
into a sphere of any size you select. PIX-FX contains many 
other features designed to help you create and enhance your 
SCREEN® creations. Some of its many applications are: reduce 
and combine several pictures into one, desk-top publishing, 
special title effects, create 3-D round objects, RLE’s, 
digitized pictures, create 3-D lettering, artistic distortions, 
personal amusement. 


PULL—-DOWN MENUS 


When you first run PIX-FX, you will be presented with a 
pull-down menu with a black & white copy of the title screen 
behind the Main Menu. Move the selection bar within the the 
menu by pressing the Up arrow (#7 key) or the Down arrow (#6 
key). Once you have moved the selection bar over your choice, 
press "ENTER" to activate your selection. To EXIT a menu without 
making a selection, press the "@" key. If you are using the Main 
Menu, pressing "@" will EXIT you to BASIC. To re-enter PIX-FX 
after returning to BASIC, just RUN as usual. You may modify or 
change any part of the BASIC program to suit your needs such as 
SAVE or LOAD to disk or COPY to full size printer. Beware that 
there is some room in memory for expansion of BASIC, however, 
not alot. If you get an "Out of Memory" error message after 
RUNning a modified program, it means that you need to find ways 
to reduce the size of your BASIC additions. See the Chapter on 
User Customizations. 
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THE HELP MENU 


When you select HELP on the PIX-FX Main Menu you will be 
presented with the Help Menu. Select the utility for which 
you need help and press "ENTER". A brief explanation will appear 
as scrolling text at the bottom of the screen. To EXIT the Help 
message, press "ENTER" and you will be taken back to the Main 
Menu. 


PIxX-FxKX TERMINOLOGY & CONVENTIONS 


PIX-FX utilizes a 256 X 176 pixel screen with the bottom two 
character lines reserved for user input and messages. PIX-FX 
does not use the color attributes during screen manipulations. 
All final SCREEN®#’s contain black and white attributes. Use any 
picture paint program to colorize your PIX-FX creations. 


PIX-FX uses two areas of RAM to store SCREENS’s being processed. 
These storage areas are called the Working Screen (WS) and the 
Final Screen (FS). The utilities; Planet Maker, Perspective, 
Magnify, Reduce, and Copy & Paste all use the following 
convention. The original SCREEN® to be worked upon is stored in 
the Working Screen area and the manipulation result SCREEN® is 
stored in the Final Screen area and is always displayed behind 
the Main Menu. In all of the above mentioned programs, cursors 
are controlled by the keyboard arrow keys (5,6,7,8). A cursor is 
used to place various cursor markers onto the screen’ thus 
Outlining a window which designates the area to be worked upon 
Or an area to place a window. The cursor shapes are an important 
Clue to help you remember which corner of a window you need to 
designate. For example, you will always begin by positioning the 
upper left-hand corner of the window you are defining, 
therefore the cursor will look like an upside-down "L" (To). 
Some programs require you to define all four corners of a 
Window, and some only require two corners to be defined. Check 
the Help Menu if you need a reminder. 


Once you have chosen any of the forementioned utilities from the 
Main Menu, you will be presented with the LOAD/MOVE Menu which 
Will allow you to place a SCREEN® to be worked on into the ws 
area. Two small windows will also be displayed which contain 
reduced versions of the WS and FS areas. This allows you to 
visualize each SCREEN® located in the storage areas. 


Final Screen 


The LOAD/MOVE Menu provides you 
with options to Copy, LOAD, or 
swap SCREENS within the storage 
areas. Once you are satisfied 
with your choices, exiting the 
menu will allow you to continue 
With your original Main Menu 
Choice. 


Working Screen 
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The SCREEN® Storage Menu gives 
you the following options: 


-View SCREEN® (Select WS or FS) 

-SAVE Final Screen (Regular 
SAVE or compressed SAVE) 

-LOAD/MOVE SCREEN® (Puts you in 
the LOAD/MOVE Menu) 

-COPY SCREEN® (COPY's picture 
to 2048 printer). You can add 
your own printer options to 
this menu by changing some 
BASIC lines. See Chapter on 
User Customization. 


[= 
ew . s | 
VE Final SCREENS 
ADsMove. SCREENS 


COPY SCREEN$-2048 is 


SCREENS MANIPULATIONS 


PLANET MAKER 


Planet Maker produces a special graphic effect by wrapping a 
SCREEN® around a sphere, thus producing a 3-D globe. After the 
LOAD/MOVE Menu, choose where you want the sphere to be drawn 
(Blank Screen or FS). Next input the angle (in degrees) you want 
to tilt your sphere. The tilt is about an imaginary point at the 
sphere center. Tilt left is positive, tilt right is negative. A 
value of plus or minus @ to 188 degrees is sufficient. The 
program will do some calculations while displaying a countdown. 
Next move the "cross" cursor to locate the coordinates of the 
sphere’s center. Press "ENTER" to set the position. Using the 
left or right arrows increases the size of the cursor and 
indicates the size of the outer edges of the sphere. Use the up 
and down arrows to decrease the scale. Press "ENTER" when you've 
decided on the scale. The value displayed is in terms of per 
cent of the total height of the "Y" axis. 


Next you must choose the offset value. Keep in mind that since 
the SCREENS is wrapped around the entire globe in 3-D, you. only 
see the part of the SCREEN® facing you. The other 58% is on the 
"dark" side of the planet. Therefore you are seeing 16 of 32 
character squares at any one time. With an offset of zero, your 
viewing window involves character spaces @ to 15, and spaces 16 
to 31 are not visible. By choosing an offset @ to 146, you can 
designate which 16 character window you want to view. 
‘When the planet is finished drawing, you’ll hear a4 beep, then 
you can press "ENTER" to get the Main Menu back. The program 
will automatically store the ¢inished work in the FS area. 
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PERSPECTIVE RENDERING 


Perspective takes a complete SCREENS and generates a 
S-dimensional perspective view that you define by the four 
corner cursors that define the window. You will be presented 
with the LOAD/MOVE Menu first. Be sure you have the SCREENS to 
be manipulated stored in the WS area. Next you choose which 
perspective option you would like. Option (1) generates 
a window where left and right sides are parallel and top = and 
bottom sides are non-parallel. Option (2) generates a window 
where top and bottom lines are parallel. 


Next indicate where you want to overlay your perspective 
drawing (on the FS screen or on a blank screen). The next step 
is to position the four corner cursors which will define the 
shape of the window. The convention is always to start with the 
Upper Left hand corner, then Lower Left, Lower Right, and 
finally the Upper Right corner in a counter-clockwise direction. 
Use the arrow keys to position each cursor at the choosen 
coordinate and press "ENTER" to set the position. If you 
attempt to move a cursor to an illegal position, error trapping 
will disable the cursor in that direction thus preventing you 
from making a positional error. 


If you wish to slow down the cursor for accurate placement, 
press and hold down "CAP SHIFT" key while pressing an arrow key. 
The "X" and "Y" coordinate values are displayed at the bottom if 
you wish to use them. To aid in alignment of the corners with 
other points on the screen, press the "C" key and the cursor 
will shoot out rays to the borders. 


After you’ve placed the fourth corner cursor, you can press "X" 
at the prompt, to redo the cursor assignments or press "ENTER" 
to continue with the program. At the outline prompt, indicate 
whether you wish the final drawing to retain the border outline. 
At the beep, the program is finished and the picture is stored 
in the FS area. 


MAGNIFY 


Magnify works different from any other magnify utilities. You 
will not input the number of times to magnify a window. Instead 
you will first define the window to be magnified then you will 
outline a window defining the size you want the first window to 
be. If the second window is larger than the first window then 
first window is magnified and takes the shape of the window. 
After you exit the LOAD/MOVE Menu you are asked if you want 
Auto-Proportioning turned on. This feature is used to assist in 
Maintaining consistant screen ratios between the "X" and "“Y" 
axes so that the window doesn’t become stretched and distorted 
on either axis. 
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If you choose "Y" then the Y-axis is automatically increased or 
decreased as the X-axis is increased or decreased. The goal here 
is to designate the window to be magnified on the WS area by 
Placing two corner cursors, one at the Upper Left corner and one 
at the Lower Right corner. Press "ENTER" to set your cursor. 
Once you’ve identified your window you will be prompted to 
indicate where you want to put the area being magnified (1) 
Whole screen or (2) a user defined window. If you choose whole 
screen then the area being magnified will fill the entire screen 
and the program ends. If you select choice #2 then you will be 
Prompted to choose where you want your window to be placed 3 (1) 
Blank screen, (2) WS area, or (3) FS area. Use the UL and LR 
corner cursors to locate the magnification area and press 
"ENTER". CAPS SHIFT gives single-step cursor speed. Pressing "C" 
gives alignment rays. 


REDUCE 


Follow prompts. Very similar to Magnify except make the second 
window smaller than the first. 


COPY & PASTE 

Follow prompts. Similar to Magnify except that when you are 
ready to locate and Paste your window you only need to locate 
the UL corner cursor and press "ENTER". 


SCREENS MODIFIER UTILITIES 


MERGE 

This utility will merge two SCREEN® into one and place the 
result into the FS area. Follow the prompts. Make sure that one 
SCREENS is in the WS area and the other is in the FS area. 
INVERSE 

This utility will invert each pixel in the FS area thus each INK 
pixel becomes PAPER and each PAPER pixel becomes INK. The result 
is placed into the FS area. 

HO L. FLIP 


This utility produces a mirror image of the Final screen. 
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COMPRESSED SCREENS SAVE 


The SAVE function of the SCREEN® Storage Menu gives you the 
option to SAVE a SCREENS in the normal way or to compress’ the 
SCREENS (reduce file size) and store as CODE. Compressing has 
two advantages: (1) it usually reduces the size of the SCREENS 
by an average of 498 to 538% and (2) the compressed code is 
preceeded by a short bit of machine code which expands’ the 
compressed SCREEN® back to its normal size. Therefore, a simple 
BASIC line like "RANDOMIZE USR 48246" will instantly produce the 
full SCREENS. This in itself has many advantages. Normal SCREENS 
take up to 6912 bytes of RAM and are slow to LOAD from cassette 
plus you need two machine code programs to store and recall the 
screens rapidly. The large size of a SCREENS file limits the 
number of them you can store in RAM. A compressed PIX-FX SCREENS 
will be smaller,is freely relocatable, and has its own built-in 
self-resolving code. You can achieve a simple form of animation 
by storing a number of slighty different compressed SCREENS then 
calling each one in sequence, like page flipping cartoons on a 
note pad. See the chapter on Advanced User Tips for using 
compressed SCREENS. 


uUusSeERF CUSTOMIZATION 


1. To make a cassette copy of PIX-FX: 

LOAD PIX-FX in the normal way. When the program has finished 
LOADing you will get a prompt to "Press A Key To RUN", it is 
important to press CAPS SHIFT and BREAK at this) point. Do not 
RUN PIX-FX and then try to SAVE it. Prepare a blank tape for 
recording the SAVE. Type in the immediate mode (no line number), 
RUN 9999, PIX-FX SAVES in four parts. 


CAUTION! The file called title is a compressed SCREENS which is 
LOADed and expanded in line 9999. When you first RUN PIX-FX, the 
title SCREENS is expanded and stored at an address which 
overwrites the compressed code you want to SAVE. Therefore, if 
you try to SAVE PIX-FX after running the program, the next time 
you LOAD PIX-FX, the program will crash when it tries to call 
USR 48246 in line 9999, 


2.To customize PIX-FX for any storage device other than cassette 

(disk drives, etc.), you should change the following BASIC 

lines: 

Line 1228; This is the SAVE SCREENS line. (N# is the file name 
from line 5589). 

Line 12483 This is the SAVE CODE line for compressed SAVE. 

Line 13563 This is the LOAD SCREEN® line. 

Line 149@3 This is the COPY SCREENS to 2948 printer line. You 
can add your own USR call to dump the screen to a 
full sized printer. 


If you wish to add a CAT routine before a LOAD, write a BASIC 
routine at line 1355. 


In line 9999, remove the BASIC that reads, "POKE PEEK 23631+256* 
PEEK 23632+5,191". 


Page 7 


The following areas of RAM are free for user use, such as 
relocatable printer drivers: 59456 to 59974 (519 bytes), 61885 
to 62868 (984 bytes), and the printer buffer at 23296 (256 
bytes). 


The Main Menu is at line 48. The Help Menu is at line 
590. The SCREEN® Storage Menu is at line 1986. The LOAD/MOVE 
Menu is at line 1392. 


ADVANCED USER TIFFS 


Some important addresses: 
location of Final Screen-49192 
location of Working Screen-46336 


Some Important POKEs: 

Speed of Menu Select Bar- 33614, (12) 

Compressed SAVE Start of SCREEN® byte: 36633, (64) + 

36689, (64). End of SCREEN® byte: 36672,(91) + 36689, (91). 
You can modify the start and end bytes to SAVE various sections 
of the screen as follaws: 


To SAVE Start End (no attributes) 
Top 1/3 of screen 64 72 
Middle 1/3 of screen 72 89 
Bottom 1/3 of screen 8g 88 
Top 2/3 of screen 64 82 
Bottom 2/3 of screen 72 88 
Whole screen (no attr.) 64 838 
Attributes only 88 Al 


When using Perspective and you wish to overlay one window over 
another screen, Perspective will "OR" or merge the pixels 
together. If you wish to overwrite what is beneath the new 
window, POKE 69145,119 which will "AND" the pixels and therefore 
PAPER over any pixel beneath. POKE 6@145,9 to "OR" the pixels. 


Some important calls: To Store FS=59975, to Recall FS=59987, to 
Store WS=69981, to Recall WS=69969 


When using Planet Maker, not all SCREEN® look interesting after 
wrapping. Other than using "WORLD.C#" SCREEN®, Planet Maker 
produces the best results when wrapping repetative patterns such 
as item #46 in PIX-FX Tour. 


Due to the TIMEX 2868's rather coarse 256x176 pixel resolution, 
results from Perspective may, at times, be better than others. 
Experiment with the differences between the “OR" and "AND" 
options at address 69145. 
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1. Select SCREEN® Storage from Main Menu (Press down arrow. and 
hit ENTER). 


2. Select LOAD/Move SCREENS, ENTER. 
-This option gives you two half sized windows displaying 
contents of the Final Screen (FS) and the Working Screen 
(WS). 
-Notice that there is nothing in the WS area. 


3S. Select COPY FS to WS from the Menu and hit ENTER. 
-Now you have placed a Copy of the FS into the WS area. 


4. Select LOAD PIC to WS, ENTER. 
-~LOAD "WORLD.C%#" (should be next on tape after PIX-FX). 
-Try swapping FS and WS a few times. 
-Put "WORLD.C#" into the WS area. Hit ENTER to EXIT. 
-Don’t forget that the MAIN MENU always displays the FS 
beneath it, 


5S. Select Perspective from the MAIN MENU. 
-You should see the LOAD/Move Menu, 

-Since Perspective will manipulate the SCREEN® found in 
the WS area check to see that you have the desired 
SCREEN® in the WS area. : 

-If everything is OK in the W area, press ENTER to 
EXIT. Sometimes you may wish to LOAD the FS area with 
another SCREENS because some Menu choices allow you 
to place your manipulated picture onto the existing 
FS SCREENS or to a blank screen. 

~You should now be in the Perspective utility. 

~Input "1" to select parallel sides, 

-Overlay onto a blank screen, "B", 

-Use the arrow keys to place the Upper Left corner 
cursor at X=@, y=13@. If the cursor moves too fast, 
hold down the CAPS SHIFT key and press the arrow 
key step-wise to slow it down for precision 
placement. 

~Press ENTER to set your selected point. 

-Move Lower Left corner cursor to xX=8, Y=28 = and 
Press ENTER. Cursor is intelligent and will prevent 
you from going in an erroneous direction. 

-Move Lower Right corner cursor to x=128, y=43,ENTER 

-Move Upper Right corner cursor to the same height 
as UL corner cursor you set first. Press the "Cc" 
key to assist in alignment. Use "CAPS SHIFT" for 
Slow cursor. Hit ENTER. 

-You should be finished and are now given a chance 
to start over if you made a mistake. Hit ENTER if 
everything is ok and you want to proceed. 

“Press "Y" for outline to appear in final rendering. 

-~VOILA!!! Hit ENTER to get back to Main Menu. 


6. Press "@" to EXIT back to BASIC. 
-Now do a "CLS" and type the following in immediate mode, 
and all on one line. Check your work carefully before 
hitting ENTER: 
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FOR N=1 TO 764: PRINT "L"3: NEXT N 

You should get a full screen pattern. Now, in the 
immediate mode again, type: RANDOMIZE USR SW (ENTER). 
This will store your pattern in the WS area. 
-Now RUN PIX-FXx. 


7. Select Planet Maker from Main Menu. 

-No changes need to be made using the LOAD/Move Menu, s0 
press ENTER to proceed. 

-We want to render our planet onto the FS area, so press 
"2", ENTER. 

-Enter the angle that you want to tilt your sphere. The 
(+) direction is counterclockwise, the (-) direction is 
clockwise. 

-The computer will do some calculations. Wait for prompt. 

-Move the "CENTER" cursor to approximately X#189, Y=130 
Press ENTER to set center coordinate of sphere. 

-Use "<--" & "-->" arrows to increase sphere diameter, use 
up/down arrows to decrease diameter, press ENTER. 

-Choose pic offset. (For now, use any number) 

-A beep will let you know that you are finished, ENTER 
will bring you back to the Main Menu. 


8. Select Reduce from the Main Menu. © 

-LOAD "BTRFLY.C®" to the WS area and hit ENTER to EXIT 
LOAD/MOVE Menu. 

-Press "Y" for auto proportioning. 

-Reduce whole screen, input "i". 

-Input "3" to print selected window to FS area. 

-Locate UL corner cursor where you want to place reduced 
picture. Try the lower right corner of the screen at 
about X=128, Y=78, press ENTER to set point. 

-The last cursor to locate is the LR corner cursor. The 
"g--" & "-->" arrows increase or decrease the window in 
proportion to the actual screen dimensions. The Up & Down 
arrows are disabled. 

-Run the LR corner cursor all the way to the right, ENTER. 


9.Select Copy & Paste from the Main Menu. 

-Using the LOAD/Move Menu, Copy FS to WS and EXIT to the 
Copy & Paste utility. 

-Use the UL and LR corner cursors to frame in N. America 
on the map. Don’t forget to use "C" to assist in framing 
the area to be copied. Press ENTER when done. 

-Print to FS at prompt. (3) 

-Now, locate the UL corner cursor to the area you want 
your copy to go. Try X#45, Y=175. Press ENTER and VOILA! 


19.Select Invert SCREEN® from the Main Menu. 
11.Select Horizontal Flip. 
This concludes our brief PIX-FX TOUR, have fun experimenting. 


There are many creative ways to use PIX-FX, whether you use it 
for professional use, personal use, or for your own amusement. 
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